home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 7 / Amiga Format AFCD07 (Dec 1996, Issue 91).iso / serious / shareware / programming / aros / readme.cvs < prev    next >
Text File  |  1996-09-13  |  5KB  |  115 lines
  1. To use the AROS CVS Server:
  2.  
  3. 1. Create a passwort with "crypt":
  4.  
  5.     > make crypt
  6.     > crypt my_password
  7.     Encrypting my_password: cbEVHg0j9uNRs
  8.  
  9. 2. Mail that password to
  10.  
  11.     digulla@wi-pc44.fh-konstanz.de
  12.     Subject: Access to AROS CVS Server
  13.  
  14.     Please add <my_login, eg. digulla> <password, eg. cbEVHg0j9uNRs>
  15.  
  16. 3. Wait until I confirm this. While you wait, look for CVS 1.8.1 and
  17. install it.
  18.  
  19. 4. When you got my reply and you have CVS 1.8.1, use this to login:
  20.  
  21.     > cvs -d user@wi-pc44.fh-konstanz.de:/home/AROS/CVS login
  22.  
  23. where "user" is your login, eg. digulla:
  24.  
  25.     > cvs -d digulla@wi-pc44.fh-konstanz.de:/home/AROS/CVS login
  26.  
  27. This asks you for your password. Type it in and if there is no error
  28. displayed, you are connected.
  29.  
  30. 5. Now you can use _any_ CVS comand as if the main source tree was
  31. on your local host. To get a complete copy of the current tree, use:
  32.  
  33.     > cvs -d :pserver:user@wi-pc44.fh-konstanz.de:/home/AROS/CVS checkout AROS
  34.  
  35. (don´t forget to substitute user by your login !)
  36.  
  37. !!! NOTE !!! IMPORTANT !!!
  38.  
  39. You must use "user@wi-pc44.fh-konstanz.de:/home/AROS/CVS" to
  40. login but ":pserver:user@wi-pc44.fh-konstanz.de:/home/AROS/CVS" to
  41. use CVS (or in other words: after login, you must prepend ":pserver:"
  42. to the argument of the -d option. This tells CVS that your are logged
  43. in.
  44.  
  45. 6. What can I do now ? Well, you can edit any file or create any number
  46. of new files. To send me your changes, you must commit them, namely with:
  47.  
  48.     > cvs -d :pserver:user@wi-pc44.fh-konstanz.de:/home/AROS/CVS commit [<file>]
  49.  
  50. where <file> is the name of a file you want to update on MY host. If
  51. you don't specify a certain file, CVS will update all files in the CURRENT
  52. DIRECTORY and ALL SUB-DIRECTORIES. This command is the last one to really
  53. make the change here on my host. All other commands simply change the
  54. state at YOUR place.
  55.  
  56. 7. What do I do it I have a new file ? Then you must register it with
  57. "cvs ... add <file>", eg.
  58.  
  59.     > cvs -d :pserver:user@wi-pc44.fh-konstanz.de:/home/AROS/CVS add some_new_file.c
  60.  
  61. This won't do anything here at my place but simply tell CVS at YOUR
  62. place that there is a new file. The next "cvs ... commit" then registers
  63. your new file here.
  64.  
  65. 8. All right but what when others change files ? In this case, nothing
  66. happens. CVS won't notice you or update your files. To tell CVS to look
  67. for new files and changes by other people (ie. make YOUR files uptodate),
  68. use
  69.  
  70.     > cvs -d :pserver:user@wi-pc44.fh-konstanz.de:/home/AROS/CVS update [<file>]
  71.  
  72. As usual, give a file if you want only this file to be checked and updated
  73. or nothing and CVS will check all files in this dir and all subdirs.
  74.  
  75. 9. What happens when two people edit the same file ? Good question. The
  76. answer is that I don't know exactly. What I know is that no changes will
  77. be lost. CVS will always keep a backup copy of the original file (it is
  78. kinda smart; it will notice when you try to change a file someone else
  79. has already changed), so there is no chance that your changes might be
  80. made in a file edited by someone else in the mean time. CVS will try
  81. to figure out what the differences are between your version and the one
  82. you used as a starting point and the version now in the repository and
  83. also the version you used as a starting point. Then these diffs are
  84. compared, too. If CVS doesn't find any places where both diffs show
  85. changes (ie. you edited somewhere at the end of the file and the other
  86. guy edited at the beginning), it will simply merge both diffs and create
  87. a new version with BOTH YOUR changes and the changes of the other person.
  88. If CVS cannot resolve all every change, it does as best as it can and
  89. then offers you a file which contains the rest: Your changes and the
  90. changes of the other person. Then you have to manually clean this up
  91. and after that CVS will use this file as the new version. At least that's
  92. what the manual says :)
  93.  
  94. 10. And now the goodie for all those who read upto here: You don't need
  95. to type the looong line above every time. If you use csh or similar
  96. (to find out, try it. If it says "setenv: command not found" then you
  97. don't :), use this:
  98.  
  99.     > setenv CVSROOT :pserver:user@wi-pc44.fh-konstanz.de:/home/AROS/CVS
  100.  
  101. on the other shells, the command looks like this:
  102.  
  103.     > export CVSROOT=:pserver:user@wi-pc44.fh-konstanz.de:/home/AROS/CVS
  104.  
  105. (have you thought to replace "user" by your login ?)
  106.  
  107. NOTE: This must be done _after_ the login !! If you do it before, CVS
  108. will try to use an existing login to login :)
  109.  
  110. After this, you can omit the "-d :pserver..." and just type, for example:
  111.  
  112.     > cvs help
  113.  
  114. Fave a lot of fun :)
  115.